home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Atari Mega Archive 2
/
Atari Mega Archive CD - Volume 2.iso
/
minix
/
up1510b.tgz
/
up1510b
/
doc
/
sz.doc
< prev
next >
Wrap
Text File
|
1990-07-19
|
15KB
|
389 lines
SZ(1) SZ(1)
NAME
sx, sb, sz - XMODEM, YMODEM, ZMODEM file send
SYNOPSIS
sz [-+abdefkLlNnopqTtuvyY] file ...
sb [-adfkqtuv] file ...
sx [-akqtuv] file
sz [-oqtv] -c COMMAND
sz [-oqtv] -i COMMAND
sz -TT
DESCRIPTION
Sz uses the ZMODEM, YMODEM or XMODEM error correcting
protocol to send one or more files over a dial-in serial
port to a variety of programs running under PC-DOS, CP/M,
Unix, VMS, and other operating systems.
While rz is smart enough to be called from cu(1), very few
versions of cu(1) are smart enough to allow sz to work
properly. Unix flavors of Professional-YAM are available
for such dial-out application.
Sz sends one or more files with ZMODEM protocol.
ZMODEM greatly simplifies file transfers compared to XMODEM.
In addition to a friendly user interface, ZMODEM provides
Personal Computer and other users an efficient, accurate,
and robust file transfer method.
ZMODEM provides complete END-TO-END data integrity between
application programs. ZMODEM's 32 bit CRC catches errors
that sneak into even the most advanced networks.
Advanced file management features include AutoDownload
(Automatic file Download initiated without user
intervention), Display of individual and total file lengths
and transmission time estimates, Crash Recovery, selective
file transfers, and preservation of exact file date and
length.
Output from another program may be piped to sz for
transmission by denoting standard input with "-":
ls -l | sz -
The program output is transmitted with the filename sPID.sz
where PID is the process ID of the sz program. If the
environment variable ONAME is set, that is used instead. In
this case, the Unix command:
ls -l | ONAME=con sz -ay -
will send a "file" to the PC-DOS console display. The -y
option instructs the receiver to open the file for writing
unconditionally. The -a option causes the receiver to
Page 1 (printed 4/18/89)
SZ(1) SZ(1)
convert Unix newlines to PC-DOS carriage returns and
linefeeds.
Sb batch sends one or more files with YMODEM or ZMODEM
protocol. The initial ZMODEM initialization is not sent.
When requested by the receiver, sb supports YMODEM-g with
"cbreak" tty mode, XON/XOFF flow control, and interrupt
character set to CAN (^X). YMODEM-g (Professional-YAM g
option) increases throughput over error free channels
(direct connection, X.PC, etc.) by not acknowledging each
transmitted sector.
On Unix systems, additional information about the file is
transmitted. If the receiving program uses this
information, the transmitted file length controls the exact
number of bytes written to the output dataset, and the
modify time and file mode are set accordingly.
Sx sends a single file with XMODEM or XMODEM-1k protocol
(sometimes incorrectly called "ymodem"). The user must
supply the file name to both sending and receiving programs.
Iff sz is invoked with $SHELL set and iff that variable
contains the string rsh or rksh (restricted shell), sz
operates in restricted mode. Restricted mode restricts
pathnames to the current directory and PUBDIR (usually
/usr/spool/uucppublic) and/or subdirectories thereof.
The fourth form sends a single COMMAND to a ZMODEM receiver
for execution. Sz exits with the COMMAND return value. If
COMMAND includes spaces or characters special to the shell,
it must be quoted.
The fifth form sends a single COMMAND to a ZMODEM receiver
for execution. Sz exits as soon as the receiver has
correctly received the command, before it is executed.
The sixth form (sz -TT) attempts to output all 256 code
combinations to the terminal. In you are having difficulty
sending files, this command lets you see which character
codes are being eaten by the operating system.
If sz is invoked with stdout and stderr to different
datasets, Verbose is set to 2, causing frame by frame
progress reports to stderr. This may be disabled with the q
option.
Page 2 (printed 4/18/89)
SZ(1) SZ(1)
The meanings of the available options are:
+ Instruct the receiver to append transmitted data to an
existing file (ZMODEM only).
a Convert NL characters in the transmitted file to CR/LF.
This is done by the sender for XMODEM and YMODEM, by
the receiver for ZMODEM.
b (ZMODEM) Binary override: transfer file without any
translation.
c COMMAND
Send COMMAND to the receiver for execution, return with
COMMAND's exit status.
d Change all instances of "." to "/" in the transmitted
pathname. Thus, C.omenB0000 (which is unacceptable to
MSDOS or CP/M) is transmitted as C/omenB0000. If the
resultant filename has more than 8 characters in the
stem, a "." is inserted to allow a total of eleven.
e Escape all control characters; normally XON, XOFF, DLE,
CR-@-CR, and Ctrl-X are escaped.
f Send Full pathname. Normally directory prefixes are
stripped from the transmitted filename.
i COMMAND
Send COMMAND to the receiver for execution, return
Immediately upon the receiving program's successful
recption of the command.
k (XMODEM/YMODEM) Send files using 1024 byte blocks
rather than the default 128 byte blocks. 1024 byte
packets speed file transfers at high bit rates.
(ZMODEM streams the data for the best possible
throughput.)
L N Use ZMODEM sub-packets of length N. A larger N (32 <=
N <= 1024) gives slightly higher throughput, a smaller
N speeds error recovery. The default is 128 below 300
baud, 256 above 300 baud, or 1024 above 2400 baud.
l N Wait for the receiver to acknowledge correct data every
N (32 <= N <= 1024) characters. This may be used to
avoid network overrun when XOFF flow control is
lacking.
n (ZMODEM) Send each file if destination file does not
exist. Overwrite destination file if source file is
newer than the destination file.
N (ZMODEM) Send each file if destination file does not
exist. Overwrite destination file if source file is
newer or longer than the destination file.
o (ZMODEM) Disable automatic selection of 32 bit CRC.
p (ZMODEM) Protect existing destination files by skipping
transfer if the destination file exists.
q Quiet suppresses verbosity.
r (ZMODEM) Resume interrupted file transfer. If the
source file is longer than the destination file, the
Page 3 (printed 4/18/89)
SZ(1) SZ(1)
transfer commences at the offset in the source file
that equals the length of the destination file.
t tim